The Additions folder contains the additions to your Symantec environment necessary to develop OpenDoc parts.
IMPORTANT: Building DR4 OpenDoc or ODF projects requires the pre-release tool set available on the Symantec C++ v8 release 4 CD. Also required is version 8.1d25 (or later) of the Symantec PowerPC C++ (provided in the Additions folder).
The following folders must be copied from the Additions folder to your hard drive and made accessible to your Symantec project tree:
OpenDoc (SPM)
SOM (SPM)
In addition the OpenDoc folder from the Environment Additions folder must be copied to your hard drive and made accessible to your Symantec project tree. You may wish to place it inside the OpenDoc (SPM) folder.
You can drop these into your Symantec folder, or put aliases to them (or to a folder containing them) into your Symantec folder's 'Aliases' folder or into individual project's folders.
Building Projects
The SamplePart projects rely on a common precompiled header which is included in the "Build Support" folder in the Development Additions for SampleCode. You will need to install this folder and manually located and build the precompiled header before you can build the Symantec sample part projects.
Debugging
The basic procedure for debugging OpenDoc part shared libraries is:
(Assume your OpenDoc part project is named "MyPart.π".)
• Create an additional project named, e.g., Test, and add the "MyPart.π" file to the Test project.
• Bring the Test project up to date. This will bring "MyPart.π" up to date, creating a debuggable shared library named "MyPart.π.pef".
• Replace the "MyPart" part shared library in the OpenDoc "Editors" folder with the "MyPart.π.pef" version.
• Make sure that the "MyPart.π" project is open in the Symantec Project Manager.
• Double-click on the Symantec Debugger to launch it. When the Launch dialog comes up, Cancel it. Leave the debugger running.
• Double-click on MyPart part stationery or a MyPart document to open it.
• Hold down the control and option keys until the Symantec Debugger comes to the foreground. You may have to select Go with control-option held down several times before the source for your part comes up in the debugger window. Once it does, you can set breakpoints in any function in your part, examine the stack, etc.